home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / misc / Splice.lha / Splice.Doc < prev   
Text File  |  1993-05-21  |  7KB  |  206 lines
  1.                          ---=== Splice Lite ===---
  2.  
  3.  
  4. Have you ever had a file which is just too darn big to fit onto a floppy 
  5. disk?  No matter how much you try and compress it, it just won't fit.  
  6. In desperation you resort to using a text editor to cut and past huge 
  7. chunks into other files, but alas the file is always corrupt when you try 
  8. and put it back together!
  9.  
  10. WELL WORRY NO MORE, Splice Lite is here!
  11.  
  12. Splice Lite is able to split ANY type of file into any size you so desire.  
  13. It has a number of built in options which lets you split files for direct 
  14. use on double density and high density disks.
  15.  
  16. It even has a disk space saver option which deletes the used source files 
  17. once the have been joined together.  And an option for formatting the file 
  18. names for use with MS-DOS (8x3 characters).
  19.  
  20.  
  21.         ----------------------------------------------------------
  22.  
  23.  
  24. Splice Lite.  Freeware version.
  25. Usage : splice {In file} [Out file] {-j} {-p#} {-s#} {-dd} {-hd} [-options]
  26.  
  27. {Commands}
  28. In file  : The name of the file to be split or joined.
  29.    -j    : JOINS specified files together.
  30.    -p#   : SPLITS the file into a specified number of PORTIONS.
  31.    -s#   : SPLITS the file into segments of a specified SIZE (KB).
  32.    -dd   : SPLITS the file into segments of 720KB for DOUBLE DENSITY disks.
  33.    -hd   : SPLITS the file into segments of 1.44MB for HIGH DENSITY disks.
  34.  
  35. [Options]
  36. Out file : Target DRIVE for the split files.
  37.    -m    : Uses MS-DOS file extensions.
  38.    -h    : HELP and information.
  39.    -x    : DELETES source files to save disk space.
  40.  
  41.  
  42.  
  43. The COMMANDS explained
  44. ^^^^^^^^^^^^^^^^^^^^^^
  45.  
  46. In file  : This is the name of the file you wish to be split, or joined. 
  47.                                   
  48.                    __________________oOo__________________
  49.   
  50. Out file : The target drive for the split files.
  51.  
  52.                    __________________oOo__________________
  53.  
  54.   -m   This command is used when either the source or destination files
  55.        are going to be used with the MS-DOS operating system.  It
  56.        basically chops anything off after the eighth character of the 
  57.        file name, and uses the extension to store the file numbers.
  58.        For example:
  59.  
  60.        AVeryLongFileName    becomes    AVeryLon.1
  61.  
  62.        If the -m option is not used the files are stored using a "_"
  63.        For example:
  64.        
  65.        AVeryLongFileName    becomes    AVeryLongFileName_1
  66.  
  67.                    _________________oOo_________________
  68.  
  69.   -h   Displays a brief summary of the main commands used within Splice.  
  70.  
  71.                    _________________oOo_________________
  72.   
  73.   -j   This toggles the JOINING mode for Splice.  If you have split
  74.        a file into a number of pieces and you wish to join them back 
  75.        together again, this command is used.
  76.        For example:
  77.  
  78.        You have:  myfile.1  myfile.2  myfile.3  myfile.4  
  79.        You want to put them together to form:  myfile.exe   
  80.        All you have to do is:
  81.  
  82.        splice myfile.exe -j
  83.  
  84.        Notice: You don't include every source file name.  
  85.        Splice will automatically search in the same directory for all 
  86.        files with the specified name.
  87.  
  88.                    _________________oOo_________________
  89.  
  90.   -p#  This option is used for SPLITTING files.  The # represents
  91.        the number of portions you want the file to be split into.  
  92.        If you have a file called  myfile  and you want it to be split 
  93.        into 4 equal portions, all you have to do is:
  94.  
  95.        splice myfile -p4
  96.  
  97.        The result will be:  myfile_1  myfile_2  myfile_3  myfile_4
  98.  
  99.                    _________________oOo_________________
  100.  
  101.   -s#  This option is similar to -p# except YOU define the size of
  102.        the portions.  For example, if you want to split myfile
  103.        into portions which will fit onto a floppy disk, you would 
  104.        use the below command:
  105.  
  106.        splice myfile -s1440
  107.  
  108.        The size should always be entered in Kilobytes. 
  109.  
  110.                    _________________oOo_________________
  111.  
  112.   -dd  This option splits the file into portions each of 720KB.
  113.        The file can then be copied onto DOUBLE DENSITY disks.
  114.  
  115.                    _________________oOo_________________
  116.  
  117.   -hd  This option splits the file into portions each of 1.440MB.
  118.        The file can then be copied onto HIGH DENSITY disks.
  119.  
  120.                    _________________oOo_________________
  121.                                             
  122.   -x   When a source file is finished with it is deleted from the system.  
  123.        This option should only be used if you have a backup copy of
  124.        your source files.  It is primarily designed for people running
  125.        low on disk space.  There is however a function which warns you 
  126.        if this option has been activated.  BE CAREFUL.
  127.  
  128.        It can be added to any of the splitting or joining operations.
  129.  
  130.  
  131. Examples
  132. ^^^^^^^^
  133.       
  134.        splice myfile -p2 -m -x
  135.        
  136.        Will SPLIT myfile into 2 portions, use MS-DOS extensions,
  137.        and DELETE all the source files.
  138.        
  139.                    _________________oOo_________________
  140.  
  141.  
  142.        splice myfile.exe -s720 -m
  143.  
  144.        Will SPLIT myfile into files no larger that 720KB, and use
  145.        MS-DOS file extensions.
  146.  
  147.                    _________________oOo_________________
  148.  
  149.  
  150.        splice myfile.exe -dd -m
  151.  
  152.        Will perform the exact same operation as above.  Remember that
  153.        -hd will SPLIT the file into segments of 1.44MB (1,440KB).
  154.  
  155.                    _________________oOo_________________
  156.  
  157.  
  158.        splice myfile.exe -j -x
  159.  
  160.        Will JOIN myfile, and delete all the source files.  Notice that
  161.        the absence of -m will cause splice to use long file names by
  162.        default.
  163.  
  164.  
  165.         ----------------------------------------------------------
  166.  
  167.  
  168. A quick disclaimer
  169. ^^^^^^^^^^^^^^^^^^
  170. I cannot be held responsible for any damaged caused directly or indirectly
  171. by the use of this program, irrespective of its correct or improper usage.
  172. All liabilities lye with the user. Use it at your own risk.
  173. Don't worry though, nobody has had any problems with it, so far!
  174.  
  175. Copyright acknowledgment
  176. ^^^^^^^^^^^^^^^^^^^^^^^^
  177. MS-DOS is a registered trademark of the Microsoft Corporation.
  178.  
  179. Splice Turbo
  180. ^^^^^^^^^^^^
  181. I am currently working on a turbo charged version of Splice which uses
  182. dynamic memory allocation rather than the fixed array type currently 
  183. implemented.  This will mean speed improvements of about 90%+ on floppy 
  184. disk operations.  Woooooo!
  185.  
  186. Other machine versions
  187. ^^^^^^^^^^^^^^^^^^^^^^
  188. There are versions of Splice Lite available for the : Amiga, Mac, 
  189. E-mail me for more information.                       PC, Sun, Vax
  190.  
  191. Wot no (C)
  192. ^^^^^^^^^^
  193. As Splice Lite is freeware you can copy it as much as you like without
  194. having to pay a penny.  Indeed, give it to all of your friends!
  195. What I would ask you to do is E-mail me if you use the program, just
  196. so I know how far and wide it spreads.
  197. Please send any suggestions and comments to: tomjerry@dcs.qmw.ac.uk
  198.                                          OR: AC4193@qmw.ac.uk
  199. Thank's to;
  200. ^^^^^^^^^^^
  201. Andrew Elia, for his input and for compiling the Amiga version (SAS/C v6.55)
  202. Alistair Railson, for eating all my food while beta testing!
  203. And all the Guy's and Gal's at QMW DCS London.
  204.  
  205. Mark Cunnell, May 1995.
  206.